.. _cmmGnSetAlarmRes:

cmmGnSetAlarmRes
================
----------------

SYNOPSYS
```````````

.. code-block:: none

    VT_I4 cmmGnSetAlarmRes (
        [in] VT_I4 Axis, [in] VT_I4 IsOn
        )


DESCRIPTION
`````````````

- 지정한 축의 알람 리셋(Reset) 출력을 제어합니다.

PARAMETER
```````````

- Axis: 축 번호. 축 번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

- IsOn : cmmGnSetAlarmRes 함수의 인자이며, 출력 상태를 설정합니다. 출력 상태는 다음과 같이 설정할 수
  있습니다.

+----------------+------------------------------+
| Value          | Meaning                      |
+================+==============================+
| 0(cmFALSE)     | 출력 상태를 비활성화 합니다. |
+----------------+------------------------------+
| 1(cmTRUE)      | 출력 상태를 활성화 합니다.   |
+----------------+------------------------------+


RETURN VALUE
`````````````

+--------------+----------------+
| Value        | Meaning        |
+==============+================+
| 음수         | 수행 실패      |
+--------------+----------------+
| cmERR_NONE   | 수행 성공      |
+--------------+----------------+


REFERENCE
```````````

- 본 함수의 사용에 대해서 주의하실 필요가 있습니다. 알람 리셋 출력을 위해서 출력 상태를 너무 오랜 시간
  지속하게 되거나 그 반대의 경우에 있어, 주요한 사항입니다. 알람 리셋 출력에 의한 반응 시간은 서보 드라이브
  사양마다 다르며, 서보 드라이브 알람 출력 시간이 너무 짧거나 길면, 알람 리셋이 되지 않거나 서보 드라이브에
  무리를 줄 수도 있습니다.

- 초기의 펄스 출력의 상태를 지정하기 위해서는 SEE ALSO 에 명시된 cmmGnPulseAlarmRes 함수를 사용하십시오. 
  cmmGnPulseAlarmRes 해당 함수는 내정된 기능을 통해서, 본 함수의 알람 리셋 On/Off 의 동작과 시간을
  바탕으로 함께 조합하여, 최종 결과물인 펄스 출력의 Alarm Reset 을 동작할 수 있으며, 해당 펄스 출력이 Rising 
  Edge 형태인지, Falling Edge 방식인지를 결정할 수 있습니다.


Example
`````````
.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 #include “Cmmsdk.h”
 #include “CmmsdkDef.h”

 void OnAlarmReset ()
 {
    long nAxisNo = 1; // ARST 신호를 출력 할 축을 선택합니다.

    /* 일정 시간 동안 ARST 신호를 내보내고, 다시 클리어 시켜줍니다. */

    cmmGnSetAlarmRes( nAxisNo, cmTRUE ); // ARST ON

    // 서보 드라이버의 알람 리셋 출력에 의한 반응 시간을 확인하여 설정하여 주시기 바랍니다.
    Sleep(50);

    cmmGnSetAlarmRes( nAxisNo, cmFALSE ); // ARST OFF
 }

 ---------------------------------------------------------------------------------------------
 Visual Basic

 Private Sub OnAlarmReset ()

    Dim nAxisNo As Long ‘ ARST 신호를 출력 할 축을 선택합니다.
    nAxisNo = 1

    ‘ 일정 시간 동안 ARST 신호를 내보내고, 다시 클리어 시켜줍니다.

    Call cmmGnSetAlarmRes( nAxisNo, cmTRUE) ‘ ARST ON

    ‘ 서보 드라이버의 알람 리셋 출력에 의한 반응 시간을 확인하여 설정하여 주시기 바랍니다.
    Sleep(50)

    Call cmmGnSetAlarmRes( nAxisNo, cmFALSE ) ‘ ARST OFF

 End Sub
 
 ---------------------------------------------------------------------------------------------
 Delphi

 procedure OnAlarmReset ();
 var
    nAxisNo : LongInt; // ARST 신호를 출력 할 축을 선택합니다.

 begin
    nAxisNo := 1;

    // 일정 시간 동안 ARST 신호를 내보내고, 다시 클리어 시켜줍니다.
    cmmGnSetAlarmRes ( nAxisNo, cmTRUE); // ARST ON

    // 서보 드라이버의 알람 리셋 출력에 의한 반응 시간을 확인하여 설정하여 주시기 바랍니다.
    Sleep(50);

 cmmGnSetAlarmRes ( nAxisNo, cmFALSE );// ARST OFF
 end;



.. seealso:: :ref:`cmmGnPulseAlarmRes` , :ref:`cmmGnGetAlarmRes`